组合Kanzi Studio 工程到Kanzi 应用程序

您可以将多个 Kanzi Studio 工程的内容组合到一个 Kanzi 应用程序。通过这种方式，您便能够：

• 跨多个团队分配 Kanzi 应用程序开发工作。每个团队都可同时处理同一个应用程序的不同部分。
• 纳入只能在 kzb 文件中提供的 Kanzi 应用程序内容。
• 使用只保留您要在多个工程中使用的资源的 Kanzi Studio 工程。
• 通过将其拆分成多个 Kanzi Studio 工程来简化 Kanzi 应用程序的结构。

例如，您在开发由多个应用程序构成的车载信息娱乐应用程序时，可以在一个或多个 Kanzi Studio 工程中开发各个应用程序。然后，使用一个 Kanzi 应用程序将这些 Kanzi Studio 工程组合到一个 Kanzi 应用程序。

要将 Kanzi Studio 工程组合到一个 Kanzi 应用程序：

• 了解如何架构包含多个 Kanzi 应用程序的 Kanzi 应用程序。请参阅 Kanzi Studio 解决方案结构。
• 使用 Kanzi Studio 工程中的预设件和资源。请参阅使用 Kanzi Studio 工程中的预设件和资源。
• 使用 kzb 文件中的预设件和资源。请参阅使用 kzb 文件中的预设件和资源。
• 合并引用的 Kanzi Studio 工程中的内容。请参阅合并引用的 Kanzi Studio 工程中的内容。

要在组合多个Kanzi Studio 工程到Kanzi 应用程序时使用主题和本地化，您必须制作应用程序的主工程屏幕 (Screen) 节点可访问的主题组和本地化表。请参阅在多个Kanzi Studio 工程组合到Kanzi 应用程序中使用主题和本地化。

通过完成教程学习如何组合 Kanzi Studio 工程中的内容。请参阅教程：将 Kanzi Studio 工程组合到一个 Kanzi 应用程序。

Kanzi Studio 解决方案结构

Kanzi Studio 解决方案是指用于将 Kanzi 应用程序组合到一个 Kanzi 应用程序的 Kanzi Studio 工程。

创建 Kanzi 解决方案时，遵循以下指南：

• 解决方案工程是 Kanzi 应用程序的主Kanzi Studio 工程。您使用它组合相关Kanzi Studio 工程，在该解决方案中构建所有 Kanzi 应用程序的代码。
• 当您创建解决方案工程时，在 Kanzi Studio 中使用最适合您所创建的应用程序类型的其中一个模板：
  • 应用程序 (Application) 模板使用 Kanzi Engine 应用程序创建 Kanzi Studio 工程。
  • 含 Kanzi Engine 插件的应用程序 (Application with Kanzi Engine plugin) 模板使用含有 Kanzi Engine 插件的 Kanzi Engine 应用程序创建 Kanzi Studio 工程。
  • 含数据源插件的应用程序 (Application with data source plugin) 模板使用含有数据源插件模板的 Kanzi Engine 应用程序创建工程。

  请参阅创建工程。
  

• 在Kanzi Studio 解决方案的 Visual Studio 工程中，添加用于定义 Kanzi 应用程序逻辑的应用程序代码。
• 如果您要添加到Kanzi Studio 解决方案的 Kanzi Studio 工程包含应用程序代码，则将类工程的 Visual Studio 工程添加到 Kanzi 解决方案工程的 Visual Studio 解决方案。
  
• 创建或挑选最适合用作解决方案工程的一个工程，在其中您可以将 Kanzi Studio 工程和 kzb 文件组合到一个 Kanzi 应用程序。
  例如，它可以是只包含应用程序代码并且从其他工程或文件获取节点和资源的工程，或者是用作所有其他应用程序的基项的现有应用程序。
• 当您导出 Kanzi 解决方案的 kzb 文件时，Kanzi Studio 会从该解决方案中的所有 Kanzi Studio 工程导出 kzb 文件至解决方案工程的 Application/bin 目录。您可以在解决方案工程的二进制导出目录 (Binary Export Directory) 属性的工程 (Project) > 属性 (Properties) 中，设置位置。
  

您向 Kanzi 解决方案添加 Kanzi Studio 工程时，请遵循以下指南：

• 对于您要添加到解决方案的工程，可使用 Kanzi Studio 工程 (Kanzi Studio project) 模板并在 Kanzi 解决方案的 Visual Studio 解决方案中定义所有这类工程的应用程序逻辑。请参阅创建工程。
  
• 将您要添加到解决方案的工程放入该解决方案工程的根目录。即便这些工程会形成层级，也得这么做。
  例如，如果您使用一个工程共享资源，使用其他工程来引用该工程，则将源工程保存在解决方案工程的根目录中。
• 当您向 Kanzi 解决方案添加引用外部文件的工程时，请将类文件复制到在 Kanzi 解决方案工程的工程属性的预览工作目录 (Preview Working Directory) 属性中设置的目录。默认情况下，这是 Kanzi 解决方案工程的 Application/bin 目录。
  
• 当您向解决方案中添加新的依赖文件时，更新解决方案构建脚本。
• 如果您要在添加到解决方案的工程中保留应用程序逻辑，当您在 Kanzi Studio 中创建工程时，请使用 应用程序 (Application)、含 Kanzi Engine 插件的应用程序 (Application with Kanzi Engine plugin) 或 含数据源插件的应用程序 (Application with data source plugin) 模板，并将这类工程的 Visual Studio 工程添加到 Kanzi 解决方案工程的 Visual Studio 解决方案。这样操作时，请务必确保：
  • 更新解决方案构建脚本，使其包含您所添加的工程。
    
  • 将解决方案的 Visual Studio 工程配置为构建 Application/bin 目录的内容和该工程所使用的依赖文件，并将其复制到解决方案的 Application/bin 目录。在 Kanzi 解决方案的 Visual Studio 解决方案中，向主工程的属性页面 (Property Pages) > 配置属性 (Configuration Properties) > 构建事件 (Build Events) > 预构建事件 (Pre-Build Event) > 命令行 (Command Line) 添加：

    if not exist "..\..\..\bin" mkdir ..\..\..\bin

    并对您添加到 Kanzi 解决方案的每个工程添加：

    xcopy ..\..\..\..\<ProjectName>\Application\bin ..\..\..\bin  /Y

  

使用 Kanzi Studio 工程中的预设件和资源

要使用 Kanzi Studio 工程中的预设件和资源:

1. 打开或创建一个您要在其中使用来自其他 Kanzi Studio 工程的内容的 Kanzi Studio 工程。
   自此，该工程被称为引用工程。
2. 在素材库 (Library) 中按下 Alt 并右键点击工程参考 (Project References)，选择现有工程 (Existing Project)，选择您要在引用工程中使用其内容的 Kanzi Studio 工程，然后点击 打开 (Open)。
   Kanzi Studio 在新的选项卡中加载工程。如果该工程包含工程引用，Kanzi Studio 加载引用指向的工程。
   自此，这些工程被称为被引用工程。
   在工程选项卡中，预览 (Preview) 图标 标记预览 (Preview) 中活动的工程。
   
   建议

   要在预览 (Preview) 中查看工程，请在工程选项卡中右键点击该工程的选项卡并选择在预览中显示 (Show in Preview)。
   

   建议

   素材库 (Library) > 工程参考 (Project References) 中的工程引用顺序决定了您在运行应用程序时 Kanzi 加载工程的 kzb 文件的顺序。

3. 在预览 (Preview) 中点击重新启动 (Restart) 并在Kzb 导出 (Kzb export) 对话框中点击是 (Yes) 导出引用工程的 kzb 文件。
   Kanzi Studio 从被引用工程创建 kzb 文件和配置文件。
   这样就让被引用工程的内容对 引用工程的预览 (Preview) 可用。
   
   建议

   默认情况下，当您重启预览 (Preview) 时，Kanzi Studio 会询问是否要导出引用工程的 kzb 文件。要设置 Kanzi Studio 无需询问而直接导出 kzb 文件，请执行以下任一操作：

   • 在 Kzb 导出 (Kzb export) 窗口启用不再询问 (Do not ask me again) 选项并点击是 (Yes)。
     
   • 选择编辑 (Edit) > 用户首选项 (User Preferences) 并在高级 (Advanced) 选项卡中将引用工程 kzb 文件导出行为 (Referenced project kzb file export behavior) 设置的值设为Always export (始终导出)。
   建议

   当 Kanzi Studio 显示在预览 (Preview) 中的工程或任何引用工程包含您尚未导出到工程的 kzb 文件中的更改时，在预览 (Preview) 中重新启动 (Restart) 按钮为橙色。
   要在预览 (Preview) 中查看内容已过期的那些工程，请悬停在按钮上。
   

4. 在工程栏中选择要使用预设件或资源的被引用工程。
   
5. 要让选项卡和资源在引用工程下拉菜单的 Kanzi Studio 中可用，请执行以下任一操作：
   • 在预设件 (Prefabs) 或素材库 (Library) 中选择预设件或资源，并在属性 (Properties) 中添加并设置跨工程可见性 (Visibility Across Projects) 属性为 公开 (Public)。
     在预设件 (Prefabs) 和素材库 (Library) 中，左上角的绿色图标标记公共项。
     
     
     建议

     要在素材库 (Library) 或预设件 (Prefabs) 中直接公开项，请右键点击该项并选择予以公开 (Make Public)。
     

   • 选择工程 (Project) > 属性 (Properties)，在属性 (Properties) 中设置跨工程资源可见性 (Resource Visibility Across Projects) 属性为公开 (Public)。
     当您将工程的跨工程资源可见性 (Resource Visibility Across Projects) 属性设置为公开 (Public) 时，就会使工程中的所有资源都可通过引用工程的下拉菜单使用。
     Kanzi Studio 使用绿色标记在工程选项卡的左上角标记公共工程。
     
     建议

     要直接从工程选项卡中让工程公开，右键点击该工程选项卡并选择予以公开 (Make Public)。
     

6. 使用引用的工程中的内容：
   • 要使用预设件，在工程 (Project) 中创建要使用该预设件的预设件占位符 (Prefab Placeholder) 或预设件视图 (Prefab View) 节点，在属性 (Properties) 中将预设件模板 (Prefab Template) 属性设为您在上一步中设为可用的预设件。
     Kanzi Studio 自动设置预设件模板 (Prefab Template) 属性，以使用该预设件的 kzb URL。
     您可以控制引用的工程中的预设件。请参阅自定义并控制 Kanzi Studio 工程中的预设件。
     
   • 要使用资源，在工程 (Project) 中选择您要使用该资源的节点，在属性 (Properties) 中将您要使用该资源的属性设为您在上一步中设为可用的资源。
     Kanzi Studio 自动设置该属性使用该资源的 kzb URL。
     
7. （可选）自定义并可控制预设件的外观。请参阅自定义并控制 Kanzi Studio 工程中的预设件。

使用 kzb 文件中的预设件和资源

要使用 kzb 文件中的预设件和资源:

1. 打开或创建一个您要使用 kzb 文件内容的 Kanzi Studio 工程。
2. 在素材库 (Library) 中按下 Alt 并右键点击工程参考 (Project References)，选择 现有 .kzb (Existing .kzb)，然后选择您要在目标工程中使用其内容的 kzb 文件，然后点击 打开 (Open)。
   如果 kzb 文件引用其他 kzb 文件，则还必须添加对这些 kzb 文件的引用。
   
3. 使用 kzb 文件中的内容：
   • 要使用某个预设件，在工程 (Project) 中创建要使用该预设件的预设件占位符 (Prefab Placeholder) 或预设件视图 (Prefab View) 节点，在属性 (Properties) 中将 预设件模板 (Prefab Template) 属性设为 <ResourceID>，然后输入您要使用的预设件的 kzb URL。
     
   • 要使用某个资源，在工程 (Project) 中选择您要使用该资源的节点，在属性 (Properties) 中将您要使用该资源的属性设为 <ResourceID>，然后输入您要使用的资源的 kzb 文件 URL。
     

自定义并控制 Kanzi Studio 工程中的预设件

当您使用 Kanzi Studio 工程中的预设件时，在 Kanzi 解决方案中，您可以设置这些预设件的内容和外观。具体方法是，使用每个您绑定到想要控制预设件内容的预设件根节点中的属性类型。

要控制 Kanzi Studio 工程中的预设件：

1. 打开或创建一个工程，并向该工程添加 Kanzi Studio 中的预设件。请参阅使用 Kanzi Studio 工程中的预设件和资源。
   自此，该工程被称为目标工程。
2. 在工程选项卡栏中，从包含您想要控制的预设件的工程中选择该预设件，在预设件 (Prefabs) 中选择预设件，并在您要用于控制该预设件的属性旁的属性 (Properties) 中点击 。
   Kanzi Studio 从该属性创建一个自定义属性，将其添加到预设件的根并创建一个 ##Template 绑定到预设件根中的属性。 这样您可以从预设件的根编辑预设件外观。
   例如，如果您要使用名为 进度 (Progress) 的属性控制音乐播放器的进度条，请点击该属性旁边的 。
   自此，该工程被称为源工程。
   
3. 在预览 (Preview) 中点击 以重启预览 (Preview) 并导出源工程的 kzb 文件。
4. 在工程选项卡栏中，选择目标工程，在工程 (Project) 中选择您用于实例化预设件（来自您要控制的源工程）的节点，然后在属性 (Properties) 中添加您在上一步中创建的自定义属性。
   现在，您可以在目标工程中使用该属性，以控制源工程中的预设件。
   

合并引用的 Kanzi Studio 工程中的内容

当您想要引入所引用 Kanzi Studio 工程中的内容时，可以合并需要的项。

要合并引用的 Kanzi Studio 工程中的内容，在素材库 (Library) > 工程参考 (Project References) 中右键点击要引入其内容的源工程，然后选择 合并工程 (Merge Project)。
合并工程 (Merge Project) 允许您仅将选定项导入目标工程。合并时，您可以选择要导入的工程项，并解决两个工程中存在的项的冲突。Kanzi Studio 将源工程中的节点与新的预设件合并。Kanzi Studio 会创建节点和资源，即便它们存在于目标工程中，并且您之前没有从同一个工程引用合并它（在这种情况下，标记为相同）。请参阅合并工程。

加载多个引用相同被引用工程的工程

Kanzi Studio 不支持在多个 Kanzi Studio 用例中加载同一工程。在 素材库 (Library) Kanzi Studio 中用红色类型标注已在另一个 Kanzi Studio 用例中加载的工程参考。如果该工程的 kzb 文件存在，则 Kanzi Studio 预览 (Preview) 显示该 kzb 文件的内容。如果卸载被引用的工程，则 预览 (Preview) 不显示该工程的内容。

当想要作为工程参考在多个 Kanzi Studio 工程中加载某一 Kanzi Studio 工程时，让这些工程成为同一 Kanzi Studio 解决方案的一部分。
例如，假设有两个 Kanzi Studio 解决方案分别名为“MainProject1”和“MainProject2”，且两者都包含引用 Resources 工程的工程。

1. 创建一个 Kanzi Studio 工程。
2. 在 素材库 (Library) > 工程参考 (Project References) 中创建 MainProject1 和 MainProject2 Kanzi Studio 工程的工程参考。
   

您现在可以使用同一 Kanzi Studio 用例编辑 MainProject1、MainProject2 和 Resources 工程。

在多个Kanzi Studio 工程组合到Kanzi 应用程序中使用主题和本地化

要在组合多个Kanzi Studio 工程到Kanzi 应用程序时使用主题和本地化，您必须以以下方式之一让主题组和本地化表对应用程序的主工程屏幕 (Screen) 节点可用：

• 在应用程序的主工程中定义主题组和本地化表。
• 将被引用工程的主题组和本地化表合并到包含屏幕 (Screen) 节点的主工程。然后，您可以使用资源 ID 访问被引用工程的主题组和本地化表中的资源。请参阅合并工程。
• 联系 Rightware 支持团队，请求获取 Kanzi Engine 插件，它能让您在多个 Kanzi Studio 工程和 kzb 文件上使用主题和本地化。请参阅提交支持请求。

另请参阅

教程：将 Kanzi Studio 工程组合到一个 Kanzi 应用程序

导入工程

合并工程

使用预设件

为应用程序制定主题

本地化

打开导航